---
title: Stripe Connect
sidebarTitle: Stripe Connect
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/stripe/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/stripe/PreBuiltUseCases.mdx"

import { StatusWidget } from "/snippets/api-down-watch/status-widget.jsx"

<StatusWidget service="stripe" />

<Overview />

**Note**
- Looking to integrate with existing Stripe accounts? Use [Stripe App](/integrations/all/stripe-app) instead.
- Stripe Connect is only for use with [Stripe's Connect product](https://stripe.com/connect), and does **not** let you access existing Stripe accounts through the REST API.

<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites     | Status           | Comment                                                                                     |
|--------------------|------------------|---------------------------------------------------------------------------------------------|
| Paid dev account   | ✅ Not required  | Free, self-signup [here](https://dashboard.stripe.com/register).                           |
| Paid test account  | ✅ Not required  | Stripe provides free test mode with full access to API and Connect features.               |
| Partnership        | ✅ Not required  | Optional — relevant for larger platforms or deeper integrations.                           |
| App review         | ✅ Required      | Required to go live with Standard Connect (OAuth-based) applications.                      |
| Security audit     | ✅ Not required  | May be required for Custom Connect depending on scope of use.                              |


## Setup guide

<Steps>
  <Step title="Create a Stripe account">
    If you don't already have one, sign up for a [Stripe account](https://dashboard.stripe.com/register).
  </Step>

  <Step title="Get your OAuth Client ID">
    Go to [Stripe Connect OAuth settings](https://dashboard.stripe.com/settings/connect/onboarding-options/oauth).

    - Enable **OAuth for Stripe Dashboard accounts**
    - Add a **Redirect URI**: `https://api.nango.dev/oauth/callback`
    - Copy your **Client ID** — you’ll need it for configuring the integration with Nango.
  </Step>

  <Step title="Get your Client Secret">
    Navigate to the [Stripe API Keys page](https://dashboard.stripe.com/apikeys) to retrieve your **Secret key**. This acts as your **Client Secret** for the integration.

    **Note**: Remember to switch to your **live secret key** in production.
  </Step>

  <Step title="Next">
    Follow the [_Quickstart_](/getting-started/quickstart).
  </Step>
</Steps>


<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/stripe.mdx)</Note>


## Useful links


| Topic     | Links                                                                               |
| --------- | ----------------------------------------------------------------------------------- |
| General   | [Website](https://stripe.com)                                                       |
|           | [Create a Stripe account](https://dashboard.stripe.com/register)                    |
| Developer | [API documentation](https://docs.stripe.com/api)                                    |
|           | [Connect overview](https://stripe.com/connect)                                      |
|           | [Dashboard Overview](https://dashboard.stripe.com/dashboard)                                |
|           | [OAuth overview](https://stripe.com/docs/connect/oauth-reference)                   |
|           | [OAuth application settings](https://dashboard.stripe.com/settings/connect/onboarding-options/oauth) |
|           | [Rate limits](https://docs.stripe.com/rate-limits)                                  |
|           | [Testing Stripe Connect](https://docs.stripe.com/connect/testing)                                  |
|           | [How to revoke account’s access](https://docs.stripe.com/connect/oauth-reference?dashboard-or-api=api#post-deauthorize)                                  |

## Common Scopes

| Permission   | Description                                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `read_write` | Grants full access to create and modify resources on behalf of connected accounts.                                          |
| `read_only`  | Grants read-only access to resources. Only applicable to **extensions**. Defaults to `read_only` for **Standard** accounts. |


<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/stripe.mdx)</Note>

## API gotchas

_No reported gotchas yet_

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/stripe.mdx)</Note>
